home *** CD-ROM | disk | FTP | other *** search
/ New Star Software Collection / NSS_Collection.iso / 3-069 qemm 603 / 1.ima / DVMAN / APPEND-I.DEV < prev    next >
Encoding:
Text File  |  1991-10-08  |  8.6 KB  |  246 lines
  1. Appendix I
  2.  
  3. Editing DESQview Scripts
  4.  
  5.  The scripts you create using DESQview's Learn feature are written to disk in
  6. a special encoded format. They cannot be viewed or changed. Sometimes it's
  7. useful to be able to see these scripts, to edit them, or to create your own
  8. scipts directly~dash~by typing in the keystrokes to the DESQview Notepad
  9. Companion or to a word processor. The Convert a Script program lets you do
  10. this.
  11.  
  12. Before you can use Convert a Script, however, you must install it in DESQview
  13. (see Adding a Program on pages 62-63). The program file is located on the
  14. drive and directory where you installed DESQview (most commonly, C:\DV).
  15.  
  16. ~Subhead~ Using the Convert A Script program
  17.  
  18.  To run the Convert a Script program:
  19.  
  20. ~Step~ Display the Open Window menu and select Convert a Script.
  21.  
  22. The Convert a Script window appears, asking you whether you want to convert
  23. a scripts file to a text file (S), a text file to a scripts file (T), or exit
  24. (X).
  25.  
  26. ~Step~ Type S and press <Enter>. Then, enter the name of the scripts file you
  27. want to convert to a text file and press <Enter>. Finally, enter the name you
  28. want to give to the converted text file and press <Enter>.
  29.  
  30.  The default name of a program's scripts file is xx-SCRIPT.DVS, where xx are
  31. the letters used to select the program from the Open Window menu~dash~or,
  32. DESQVIEW.DVS for scripts for the DESQview menu.
  33.  
  34. ~Step~ Edit the text file using your favorite word processor. Save as an
  35. ASCII file (no formatting). 
  36.  
  37. ~Step~ Switch back to the Convert a Script window. Type T and press <Enter>.
  38. Enter the name of the text file you just edited and press <Enter>. Then,
  39. enter the name you want the scripts file to have (normally, its original
  40. name) and press <Enter>.
  41.  
  42. As each line of the text file is converted to a scripts file, it's displayed
  43. in the Convert a Script window. If an error is found, processing stops after
  44. displaying the line containing the error~dash~press any key to continue
  45. processing the rest of the file. Then, to load the modified scripts:
  46.  
  47. ~Step~ Switch back the program whose scripts you just edited and use the Load
  48. Scripts command to load the modified scripts (see page 89).
  49.  
  50. ~Subhead~ Editing Scripts Using the Notepad Companion
  51.  
  52.  If you have the Notepad Companion, you can edit scripts files directly. 
  53. When you load a file with the extension DVS into Notepad, it automatically
  54. converts it into a text file~dash~and then back to a scripts file when you
  55. save it.
  56.  
  57. ~Step~ Start up DESQview Notepad. Type N to select "non-document" mode. 
  58. Then, enter the script name and press <Enter>.
  59.  
  60. ~Step~ Modify or delete existing scripts, add new scripts, or both. Then,
  61. terminate editing by typing ^KC.
  62.  
  63. ~Step~ Put the modified scripts into effect by re-loading the  scripts file.
  64.  
  65. ~Subhead~ How to Edit a Script File
  66.  
  67.  When you convert a scripts file to a text file (or when you load a scripts
  68. file into DESQview Notepad), each script is converted into its textual
  69. representation, which can be edited and then converted back to scripts file
  70. format. The standard typewriter keys appear as themselves. All other keys are
  71. represented by the "key labels" delimited by curly brackets. The tables in
  72. the remainder of this appendix list the complete set of valid "key labels"
  73. and special Learn keys that DESQview recognizes. There can be any number of
  74. scripts in a scripts file. 
  75.  
  76.  Each script has the folowing 3 directives:
  77.  
  78.  1.  {Learn KEY "script name"}   or: {Learn {key label} "script name"}
  79.  2.  keystrokes 
  80.  3.  {Finish}
  81.  
  82. where:
  83.  
  84. ~Item~ KEY is the actual typewriter key;  key label  is the name of the key
  85. being redefined. For example, X is the typewriter key, X (case significant);
  86. {F1} is the key label for the function key, F1; {Alt-0} is the key label for
  87. the Alt-O (case insignificant) combination keypress.  
  88.  
  89. ~Item~ script name is the name of the script as it should appear on the
  90. Display Scripts menu. The script name may have embedded blanks. The quotes
  91. are mandatory. To omit the script name, enter "".
  92.  
  93. ~Item~ keystrokes is the body of the script~dash~that is, all of the keys and
  94. key labels (listed below and on the next two pages) that the script performs
  95. when it's played back. You may have an unlimited number (except for buffer
  96. size~dash~see page 84) of keystrokes in a script. 
  97.  
  98. ~Item~ {Finish} is the label that marks the end of an individual script in a
  99. scripts file.
  100.  
  101.  Line feeds and carriage returns in the file are ignored, so keystrokes can
  102. be as long as you need.  All other keys are part of the script.
  103.  
  104. ~Subhead~ Special Learn Keys
  105.  
  106.  The special Learn key names listed below are recognized during script
  107. playback.
  108.  
  109. Begin Table
  110.  
  111. {^Alt-Del}, Abort the Current Window.
  112.  
  113. {Delay n}, Wait for n seconds.
  114.  
  115. {DESQ}, Display the DESQview menu.
  116.  
  117. {Display-Scripts}, Display the Display Scripts menu.
  118.  
  119. {Finish}, Terminates script definition.
  120.  
  121. {Fixed-Pause n}, Pause until n characters are typed.
  122.  
  123. {Learn key "name"}, Start defining a new script (embedded learn).
  124.  
  125. {Load-Scripts "filename"}, Load the scripts file filename.
  126.  
  127. {Save-Scripts "filename"}, Save scripts to the file filename.
  128.  
  129. {Switch}, Switch to the next window in turn.
  130.  
  131. {Variable-Pause}, Pause until <Enter> is entered.
  132.  
  133. ~End Table~ 
  134.  
  135. ~Subhead~ Standard Keys and Extended Codes
  136.  
  137.  The standard typewriter keys are entered into Learn scripts themselves.  The
  138. standard PC extended key codes are entered into Learn scripts as the key name
  139. enclosed in curly brackets~dash~as listed below.
  140.  
  141. ~Begin Table~ 
  142.  
  143. Standard Keys and Extended Codes
  144.  
  145.  
  146. Letters
  147.  Lowercase, a to z
  148.  Uppercase, A to Z
  149.  With Ctrl, {^A } to {^Z}
  150.  With Alt, {Alt-A} to {Alt-Z}
  151.  
  152. Numbers
  153.  Alone, 0 to 9
  154.  With Alt, {Alt-0} to {Alt-9}
  155.  
  156. Symbols 
  157.  Alone, . ,    ;    :    '    "    /               `   <    >    ?    !    
  158. %    \    &    *    +    -    =            ^
  159. (    )    [    ]    {    }    |               _
  160.  With Ctrl, {^/}  {^[}  {^]}  {^^}  {^   _ }
  161.  With Alt, {Alt- ~dash~}     {Alt- =}
  162.  
  163. Function Keys 
  164.  Alone, F1 to F10
  165.  With Shift, {Shift-F1} to {Shift-F10}
  166.  With Ctrl, {^F1} to {^F10}
  167.  With Alt, {Alt-F1} to {Alt-F10}
  168.  
  169. Other Keys
  170.  Alone, {BackSpace} {Left} {BackTab} {LineFeed} {Del} {Null} {Down}        
  171.  {PgDn}  {End} {PgUp} {Enter} {Right} {Esc} {Space} {Home} {Tab} {Ins}  {Up}
  172.  With Ctrl, {^BackSpace} {^Break} {^PgUp} {^End} {^PrtSc} {^Home} {^Right}
  173.   {^Left}
  174.  
  175. Keypad Keys
  176.  Numbers  {Keypad 0} to {Keypad 9}
  177.  Symbols, {Keypad +}   {Keypad *}{Keypad -}   {Keypad .}
  178.  
  179. ~End Table~ 
  180.  
  181.  To enter the {` key alone, use {{}.
  182.  
  183.  The 255 ASCII codes can also be entered as {1} to {255}.
  184.  
  185.  Any scan code can be entered as a signed decimal number, {-32768} to
  186. {32767}. For example, you could enter the scan code 4E2BH (gray +) as
  187. {20011}.
  188.  
  189.  ASCII 0 is known as {Null}.  You cannot enter it as {0} or {^.
  190.  
  191.  {LineFeed} is generated by pressing ^Enter.
  192.  
  193.  ` has special meaning to Learn (see page 40). You must press it twice to
  194. enter a single `.
  195.  
  196. ~Subhead~ Enhanced Keyboard Keys
  197.  
  198.  The enhanced PC keyboard has additional extended key codes that aren't
  199. available on regular PC, PC-XT, or PC-AT keyboards~dash~as listed below. 
  200.  
  201. ~Begin Table~ 
  202.  
  203. Enhanced PC Keyboard Only
  204.  
  205. Symbols, With Alt,       {Alt-.}   {Alt-[}        {Alt-,}   {Alt-]}        
  206. {Alt-;}   {Alt-\}        {Alt-'}   {Alt-`}        {Alt-/}
  207.  
  208. Function Keys
  209.  Alone, F11 to F12
  210.  With Shift, {Shift-F11} to {Shift-F12}
  211.  With Ctrl, {^F11} to {^F12}
  212.  With Alt, {Alt-F11} to {Alt-F12}
  213.  
  214.  
  215. Other Keys
  216.  With Ctrl,  {^Tab}
  217.  With Alt,   {Alt-BackSpace} {Alt-Esc} {Alt-Enter} {Alt-Tab}
  218.  
  219. Keypad Keys
  220.  Alone, {Center Cursor} {Keypad LineFeed}{Keypad Enter} {Keypad /}          
  221.  With Ctrl, {^Center Cursor}   {^Keypad -} {^Del} {^Keypad *} {^Down} 
  222.            {^Keypad /} {^Ins}  {^Up}  {^Keypad +}                  
  223.  With Alt, {Alt-Keypad Enter}   {Alt-Keypad *}     {Alt-Keypad +}       
  224.     {Alt-Keypad /}  {Alt-Keypad -}
  225.  
  226. Cursor Pad Keys
  227.  Alone, {CursorPad Del}~dagger~      {CursorPad Left}~dagger~
  228.     {CursorPad Down}~dagger~ {CursorPad PgDn}~dagger~
  229.     {CursorPad End}~dagger~     {Cursor Pad Up}~dagger~
  230.     {CursorPad Home}~dagger~ {CursorPad PgUp}~dagger~
  231.     {CursorPad Ins}~dagger~   {CursorPad Right}~dagger~
  232.  With Ctrl, {CursorPad^Del}   {CursorPad^Left}~dagger~
  233.         {CursorPad^Down} {CursorPad^PgDn}~dagger~
  234.         {CursorPad^End}~dagger~ {CursorPad^PgUp}~dagger~
  235.         {CursorPad^Home}~dagger~ {CursorPad^Right}~dagger~
  236.         {CursorPad^Ins} {CursorPad^Up}
  237.  With Alt,    {Alt-Del} {Alt-Left}{Alt-Down} {Alt-PgDn}  {Alt-End}                     {Alt-Right}{Alt-Home}     
  238.             {Alt-PgUp}{Alt-Ins} {Alt-Up}
  239.  
  240. ~End Table~ 
  241.  
  242. ~Table Note~
  243.  ~dagger~
  244. Indicates keys that are understandable by programs not
  245. written for the enhanced PC keyboard.
  246.